home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / gcc / gcc260utilsdoc.lha / gnu / man / man1 / od.1 < prev    next >
Encoding:
Text File  |  1994-07-26  |  7.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4. OD(1L)            Misc. Reference Manual Pages             OD(1L)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      od - dump files in octal and other formats
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      oooodddd [-abcdfhiloxv] [-s[bytes]] [-w[bytes]] [-A  radix]  [ - j
  13.      bytes] [-N bytes] [-t type] [--skip-bytes=bytes] [--address-
  14.      radix=radix] [--read-bytes=bytes] [--format=type] [--output-
  15.      duplicates]  [--strings[=bytes]] [--width[=bytes]] [--tradi-
  16.      tional] [--help] [--version] [file...]
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      This manual page documents the GNU version of oooodddd.  oooodddd writes
  20.      to  the  standard output the contents of the given files, or
  21.      of the standard input if the name `-' is given.   Each  line
  22.      of  the  output  consists of the offset in the input file in
  23.      the leftmost column of each line, followed by  one  or  more
  24.      columns of data from the file, in a format controlled by the
  25.      options.  By default, oooodddd prints the file  offsets  in  octal
  26.      and the file data as two-byte octal numbers.
  27.  
  28.   OOOOPPPPTTTTIIIIOOOONNNNSSSS
  29.      -_A, --_a_d_d_r_e_s_s-_r_a_d_i_x=_r_a_d_i_x
  30.           Select the base in  which  file  offsets  are  printed.
  31.           _r_a_d_i_x can be one of the following:
  32.  
  33.           d    decimal
  34.  
  35.           o    octal
  36.  
  37.           x    hexadecimal
  38.  
  39.           n    none (do not print offsets)
  40.  
  41.      The default is octal.
  42.  
  43.      -_j, --_s_k_i_p-_b_y_t_e_s=_b_y_t_e_s
  44.           Skip _b_y_t_e_s input bytes before formatting  and  writing.
  45.           If bbbbyyyytttteeeessss begins with `0x' or `0X', it is interpreted in
  46.           hexadecimal; otherwise,  if  it  begins  with  `0',  in
  47.           octal; otherwise, in decimal.  Appending `b' multiplies
  48.           it by 512, `k' by 1024, and `m' by 1048576.
  49.  
  50.      -_N, --_r_e_a_d-_b_y_t_e_s=_b_y_t_e_s
  51.           Only output up to _b_y_t_e_s bytes of each input file.   Any
  52.           prefixes  and  suffixes on bbbbyyyytttteeeessss are interpreted as for
  53.           the -_j option.
  54.  
  55.      -_t, --_f_o_r_m_a_t=_t_y_p_e
  56.           Select the format in which to  output  the  file  data.
  57.           _t_y_p_e is a string of one or more of the below type indi-
  58.           cator characters.  If you include more  than  one  type
  59.           indicator character in a single _t_y_p_e string or use this
  60.  
  61.  
  62.  
  63. FSF              Last change: GNU Text Utilities                1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. OD(1L)            Misc. Reference Manual Pages             OD(1L)
  71.  
  72.  
  73.  
  74.           option more than once, oooodddd writes one copy of each  out-
  75.           put  line  using each of the data types that you speci-
  76.           fied, in the order that you specified.
  77.  
  78.           a    named character
  79.  
  80.           c    ASCII character or backslash escape
  81.  
  82.           d    signed decimal
  83.  
  84.           f    floating point
  85.  
  86.           o    octal
  87.  
  88.           u    unsigned decimal
  89.  
  90.           x    hexadecimal
  91.  
  92.      Except for types `a' and `c', you can specify the number  of
  93.      bytes  to  use in interpreting each number in the given data
  94.      type by  following  the  type  indicator  character  with  a
  95.      decimal  integer.   Alternately, you can specify the size of
  96.      one of the C compiler's built-in data types by following the
  97.      type  indicator  character with one of the following charac-
  98.      ters.  For integers (d, o, u, x):
  99.  
  100.           C    char
  101.  
  102.           S    short
  103.  
  104.           I    int
  105.  
  106.           L    long
  107.  
  108.      For floating point (f):
  109.  
  110.           F    float
  111.  
  112.           D    double
  113.  
  114.           L    long double
  115.  
  116.      -_v, --_o_u_t_p_u_t-_d_u_p_l_i_c_a_t_e_s
  117.           Output  consecutive  lines  that  are  identical.    By
  118.           default,  when  two  or  more  consecutive output lines
  119.           would be equal, oooodddd outputs only  the  first  line,  and
  120.           puts just an asterisk on the following line to indicate
  121.           that identical lines have been elided.
  122.  
  123.      -_s, --_s_t_r_i_n_g_s[=_b_y_t_e_s]
  124.           Instead of the normal output, output only  string  con-
  125.           stants  in the input, which are a run of at least _b_y_t_e_s
  126.  
  127.  
  128.  
  129. FSF              Last change: GNU Text Utilities                2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. OD(1L)            Misc. Reference Manual Pages             OD(1L)
  137.  
  138.  
  139.  
  140.           ASCII graphic (or formatting) characters, terminated by
  141.           a NUL.  If _b_y_t_e_s is omitted, it defaults to 3.
  142.  
  143.      -_w, --_w_i_d_t_h[=_b_y_t_e_s]
  144.           The number of input bytes to format  per  output  line.
  145.           It  must  be a multiple of the least common multiple of
  146.           the sizes associated with the specified  output  types.
  147.           If _b_y_t_e_s is omitted, it defaults to 32.  If this option
  148.           is not given, it defaults to 16.
  149.  
  150.      --_h_e_l_p
  151.           Print a usage message and exit with a non-zero status.
  152.  
  153.      --_v_e_r_s_i_o_n
  154.           Print version information on standard output then exit.
  155.  
  156.      The next several  options  map  the  old,  pre-POSIX  format
  157.      specification  options  to  the  corresponding  POSIX format
  158.      specs.  GNU oooodddd accepts any combination of old- and new-style
  159.      options.  Format specification options accumulate.
  160.  
  161.      -_a    Output as named characters.  Equivalent to -_t _a.
  162.  
  163.      -_b    Output as octal bytes.  Equivalent to -_t _o_C.
  164.  
  165.      -_c    Output  as  ASCII  characters  or  backslash  escapes.
  166.           Equivalent to -_t _c.
  167.  
  168.      -_d    Output as unsigned decimal shorts.  Equivalent to  - _t
  169.           _u_2.
  170.  
  171.      -_f    Output as floats.  Equivalent to -_t _f_F.
  172.  
  173.      -_h    Output as hexadecimal shorts.  Equivalent to -_t _x_2.
  174.  
  175.      -_i    Output as decimal shorts.  Equivalent to -_t _d_2.
  176.  
  177.      -_l    Output as decimal longs.  Equivalent to -_t _d_4.
  178.  
  179.      -_o    Output as octal shorts.  Equivalent to -_t _o_2.
  180.  
  181.      -_x    Output as hexadecimal shorts.  Equivalent to -_t _x_2.
  182.  
  183.      --_t_r_a_d_i_t_i_o_n_a_l
  184.           Recognize the pre-POSIX non-option arguments that  some
  185.           older versions of od accepted.  The following syntax
  186.           oooodddd    -   -   traditional    [file]    [[+]offset[.][b]
  187.           [[+]label[.][b]]]
  188.           can be used to specify at most one  file  and  optional
  189.           arguments  specifying  an  offset  and  a  pseudo-start
  190.           address, _l_a_b_e_l.  By default, _o_f_f_s_e_t is  interpreted  as
  191.           an octal number specifying how many input bytes to skip
  192.  
  193.  
  194.  
  195. FSF              Last change: GNU Text Utilities                3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. OD(1L)            Misc. Reference Manual Pages             OD(1L)
  203.  
  204.  
  205.  
  206.           before formatting and writing.  The  optional  trailing
  207.           decimal  point forces the interpretation of _o_f_f_s_e_t as a
  208.           decimal number.  If no decimal  is  specified  and  the
  209.           offset  begins with `0x' or `0x' it is interpreted as a
  210.           hexadecimal number.  If there is a  trailing  `b',  the
  211.           number  of  bytes  skipped will be _o_f_f_s_e_t multiplied by
  212.           512.  The  label  argument  is  interpreted  just  like
  213.           offset,  but  it  specifies  an initial pseudo-address.
  214.           The pseudo addresses are displayed in parentheses  fol-
  215.           lowing any normal address.
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. FSF              Last change: GNU Text Utilities                4
  262.  
  263.  
  264.  
  265.